Frequently Asked Questions

Here is a list of problems and frequently asked questions about minitoc.sty. If your version has a number less than 24, please upgrade to version #24.

  1. How avoid a page break near the rules before and after the minitoc?
    This problem seemed solved since version #8, but version #12 adds better fixes.
  2. How about implementing others layouts for the minitoc? Suggestions are welcome.
  3. \\ in a contents line makes an error.
    Use \protect\linebreak.
  4. If you reorder chapters, havoc follows... minitocs going in wrong chapters.
    The best way seems to make one run with the minitocoff package replacing the minitoc package, then restore the minitoc package and re-execute LATEX three times (yes, it is time consuming...). Running with the minitocoff package ensures that auxiliary are cleared from ``spurious'' commands introduced by minitoc.
  5. This option creates auxiliary files with extensions like .mtcN>. Some operating systems allow only 3 letters extensions. What to do?
    If you have an operating system which tolerates only short file name extensions (of 3 characters, like with MS-DOS), you must edit the file minitoc.sty: find the line containing ``%\def\SHORTEXT'' and remove the leading percent sign. No other modification is needed: all is automatic!
  6. Do not cheat with the ``chapter'' counter, i.e. do not write horrible things like \setcounter{chapter}{6}. The mechanism would break. It is better to add \chapter commands, to create empty (but numbered in a legal way) chapters. Since version #10, minitoc.sty works with appendices. Version #19 allows to begin with a chapter other that number 1.
  7. Some demanding users want to have minilof, minilot and minibbl. First, minibbl is an other problem, strongly related to the BIEM BTEX's dealing with .aux files. Look at chapterbib.sty. Version #13 has implemented basic minilofs and minilots. Minibbls are not the aim of this package.
  8. This package creates a lot of auxiliary files and some users argue that it is too many. A deep redesign would be necessary to avoid that. Using only one big auxiliary file (or one for all minitocs, one for all minilofs, ...) would make the reading of such file very slow, and it would be read for each \miniXXX macro!
  9. How to do minitocs (minilofs and minilots) at levels other than chapter? Here also, some redesign is needed. From version #15, there are parttocs, partlofs and partlots for the part level in book-like and article-like documents, secttocs, sectlofs and sectlots for the section level in article-like documents. Note that you can not have minitocs features at chapter and section level in the same document, because doing so would make an unreadable monster. The user must choose the main style of the document accordingly to the size of it (e.g. do not write an article of more than 130 sections: this is a report, or even a book!).

    part chapter sectionPj
    book * * Pj
    report * * Pj
    article * *Pj
  10. Since version #23, works with document classes resetting chapter (or section) number at each part.